Usando GitHub com R e RStudio

Aprenda a integrar GitHub e RStudio para versionamento de projetos de análise de dados.
Autor
Afiliação

Alessandra Menezes

Universidade Federal de São Paulo (UNIFESP)

Data de Publicação

14 de julho de 2025

🚀 Introdução

Bem-vindo! Este tutorial foi feito para quem nunca usou Git ou GitHub, especialmente no contexto de ciência de dados com R.

🎯 O que você vai aprender

  • O que são Git e GitHub e por que usá-los;
  • Como instalar e configurar o ambiente de trabalho no RStudio;
  • Como criar projetos no GitHub e no RStudio;
  • Como salvar e compartilhar seu trabalho usando versionamento.

🧠 Entendendo o Git e o GitHub

📦 O que é Git?

Git é como uma máquina do tempo para o seu projeto. Ele salva versões do seu código, permitindo que você volte atrás, colabore e mantenha tudo organizado.

Git logo

☁️ O que é GitHub?

GitHub é uma plataforma online que guarda seus projetos Git e permite que você trabalhe com outras pessoas.

GitHub logo

🧰 Configurando o ambiente

  1. Faça o download conforme seu sistema operacional e siga as instruções de instalação.

  2. Depois, vá até o menu: Tools > Global Options > Git/SVN.

  3. Se o campo Git executable estiver vazio ou com erro, será necessário configurar o caminho do executável do Git.

  4. Localize o caminho correto e preencha o campo Git executable:

    • Windows: C:/Program Files/Git/bin/git.exe; ou
    • MacOS/Linux: /usr/bin/git (em geral).

  5. Clique em OK para salvar as configurações.

  6. Abra o terminal do RStudio e configure seu nome e email do Git:

    git config --global user.name "Seu Nome"
git config --global user.email "email@example.com"

  7. Abra o terminal integrado do RStudio (Tools > Terminal > New Terminal). Devem ficar visiveis dois elemento visuais: o menu suspenso “Git/Controle” de versão e a guia “Git/Controle de versão”.

Elementos visuais relacionados ao Git

📘 Conceitos fundamentais

  1. Repositório: pasta do projeto com controle de versão
  2. Clone: copiar um repositório remoto para o local
  3. Fork: criar uma cópia de um repositório para modificar
  4. Commit: um registro de alterações
  5. Push: enviar alterações para o GitHub a partir do RStudio
  6. Pull: baixar alterações do GitHub para o RStudio

Fluxo de trabalho entre GitHub e projeto local no RStudio

🔗 Conectando o GitHub ao RStudio

No GitHub

  1. Crie um novo repositório e dê um nome significativo, que identifique a natureza do projeto.
  2. Marque a opção “Add a README”. Isso cria um arquivo README.md para descrever o projeto.
  3. Escolha a licença (opcional, mas recomendado).
  4. Clique em “Create repository”.

No RStudio

  1. Crie um novo projeto de controle de versão: File > New Project > Version Control > Git.
  2. Cole a URL do repositório criado no GitHub.
  3. Clone o projeto localmente:
    • Selecione a pasta onde o projeto será salvo.
    • Marque a opção “Create a git repository”.
  4. Escolha o diretório onde o projeto será salvo.
  5. Clique em “Create Project”. Isso cria um novo projeto RStudio vinculado ao repositório GitHub.

✍️ Trabalhando com Git no RStudio

  1. Trabalhe no projeto, adicionando arquivos, fazendo análises.
  2. Depois vá para a aba “Git”. Você verá os arquivos modificados, novos arquivos e arquivos deletados.
  3. Selecione os arquivos que deseja incluir no commit.
  4. Clique em “Commit” para abrir a janela de commit.
  5. Adicione uma mensagem de commit descritiva.
  6. Clique em “Commit” para registrar as alterações localmente.
  7. Para enviar as alterações para o GitHub, clique em “Push”.
  8. Para baixar as alterações do GitHub, clique em “Pull”.

🧪 Atividade Prática

Você vai clonar o repositório desse tutorial e fazer algumas modificações:

  1. Clone o repositório tutorial GitHub.
  2. Crie um arquivo resumo.R com o código:
summary(iris)
  1. Salve o arquivo resumo.R no diretório do repositório clonado.
  2. Vá para a aba “Git” no RStudio, você verá o arquivo resumo.R listado como modificado.
  3. Selecione o arquivo resumo.R e clique em “Commit”.
  4. Escreva uma mensagem de commit, como “Adiciona resumo da base iris”.
  5. Clique em “Commit” para registrar as alterações localmente.
  6. Clique em “Push” para enviar as alterações para o GitHub.
  7. Verifique no GitHub se o arquivo resumo.R foi adicionado corretamente.

🧠 Dicas e boas práticas

  • Sempre trabalhe em um repositório clonado localmente;
  • Sempre faça commits frequentes e significativos;
  • Use mensagens de commit claras e descritivas;
  • Mantenha o repositório organizado com pastas para scripts, dados e resultados;
  • Sempre faça pull antes de começar a trabalhar para evitar conflitos;
  • Use o arquivo .gitignore para excluir arquivos temporários ou desnecessários do controle de versão;
  • Mantenha o README atualizado com informações sobre o projeto, como instalação, uso e contribuições.

📚 Para saber mais!